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LEARN TO 
CODE WITH C 


he C programming language was 

invented in the early 1970s, and 

since then has become one of the 
most popular and widely used general- 
purpose languages. It’s used by a wide range 
of programmers, from amateurs working 
on simple projects at home, to industry 
professionals who write in C for a living. It’s 
been used to program everything from the tiny 
microcontrollers used in watches and toasters 
up to huge software systems - most of Linux 
(and Raspbian itself) is written in it. It can 
give you control over the smallest details of 
how a processor operates, but is still simple to 
learn and read. This series is an introduction 
to programming in C for absolute beginners, 
you don’t need any previous programming 
experience, and a Raspberry Pi running 
Raspbian is all you need to get started. 
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CHAPTER ONE 
GETTING 


STARTED 


Cis one of the most widely used programming 
languages - learn how to use it to program the Pi! 
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pi@raspberry: ~ «at Jhello.c - /home/pi - б. 
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stebasket 


File Edit Search View Document Project Build Tools Help 
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Symbols |> | hello.e х 


9 Functions 1) include «std 
void main (void) = piGresph 


File Edit Tabs Help 


f main [3] 


3 
4 

5 printf ( % 
S 
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Status 14:40:09: This is Geany 1.24.1 

"3 14:40:09: File /home/pi/.themes/PiX/gtk-2.0/gtkrc opened(1). 

14:40:09: File /home/pi/dev/l«panel/plugins/ejecter/ejecter.c opened(2). 
14:40:15: File /home/pi/.themes/PIX/gtk-2.0/gtkrc closed. 


14:40:16: File /home/pi/dev/I«panel/pluginsejecter/ejecter.c closed. 


You use a text editor like You use the command 


Geany to enter your C 
program before compiling it 


line to compile and 
run C programs 


[ CHOOSE What's so great about C? 
МӘШЕЙЧЕШЕЕЙ| C is avery powerful language - there's not much you can’t use it for - 
but it's fairly simple. The language itself only has 20 or so keywords, 
but there's a huge library of additional functions that you can call in 
when you need them. In this series, we're going to concentrate on 
learning about the keywords, with a few of the more useful library 
functions thrown in for good measure. 
Many of the languages that you may have seen, such as Python, 
are what are called interpreted languages. This means that the code you 
write is run directly: each line of code is read in and interpreted as you 
run it. C is different: it's a compiled language. This means that the code 
you write, known as the source code, is never run directly. The source 
code is passed through a program called a compiler, which converts it 
into a machine-readable version called an executable or a binary; you 
then run the resulting executable. 
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[ WHITESPACE 
DOESN'T 
MATTER! ] 


Unlike Python, 
whitespace 
has no 
significance 

in C - you can 
put spaces, 
tabs, and new 
lines anywhere 
you like in a 

C program 

to make it 
readable. 


This may seem complex, but it has a few big advantages. First, 
it means that you don't need to have a copy of C itself on every 
computer you want to run your program on; once compiled, 
the executable is stand-alone and self-contained. Second, the 
compilation process will find a lot of errors before you even run the 
program (but it won't usually find all of them). Most importantly, the 
compilation process means that the time-consuming translation of 
human-readable code into machine-readable instructions has already 
happened, which means that compiled code generally runs many 
times faster than interpreted code would. 


Hello world - your first C program 

With all that out of the way - which has hopefully made you think 

that C might be worth learning - let's have a look at the first program 
everyone writes in any language, the one that prints ‘Hello World’ on 
the screen. Incidentally, the tradition of writing a Hello World program 
was first introduced with the original documentation describing C 
itself. Just think: no C, no Hello World... 


&include «stdio.h» 


void main (void) 
{ 
/* A print statement */ 
printf ("Hello world!\n"); 
h 


Hopefully not too frightening! Let's look at it line by line. 
#include <stdio.h> 


This is known as a hash-include. As mentioned above, the C 
language has a large library of functions that can be included, and 
we need to use one of them in this program: the formatted print 
command printf. This is part of the standard input-output library, 
or stdio for short. So what this line does is to warn the compiler that 
the program needs the stdio library to be included as part of the 
compile process. 
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void main (void) 


Cis a function-based language; every program is made up 
of a number of functions. 

Fach function takes zero or more arguments, and returns a single 
value. A function definition consists of a specification of what the 
function returns (in this case, a void), a function name (in this 
case, main), and a list of arguments enclosed in round brackets 
(again, a void). 

Every C program has to include a function called main; when you run 
the compiled program, the main function is the first thing that executes. 

The word void is called a type specifier; a void is a special type which 
means ‘no value required’. We'll look more at types in the next chapter. 

So this line defines the main function for this program; it states that 
the main function takes no arguments, and returns no value. 

The code which makes up the function itself is enclosed between 
the two curly brackets () that follow the function definition. 


/* A print statement */ 


First, we have a comment telling us what's going on. Comments in 
C start with the symbol /*, and end with */ - anything between those 
two symbols is ignored by the compiler. 

The code itself is just one line: 


printf ("Hello world!\n"); 


" | [ CHECK YOUR 
This is a call to the printf (‘print formatted’) function from the BRACKETS ] 
stdio library. In this case, it takes a single argument, which is a text 
string enclosed within double quotes. As mentioned above, function Unlike 
arguments are enclosed in round brackets еза 
8 : Я . ) . punctuation is 
Note that the line ends with a semicolon. All statements in C must very important 
finish with a semicolon; this tells the compiler that this is the end in C - make 
: : : sure you don't 
of a statement. One of the most common beginner mistakes in C use a curly 
is to forget a semicolon somewhere! bracket where 
What about the string itself? The Hello World! bit is a round one 


is needed, or 
vice versa. 


straightforward enough, but what about that Xn at the end? Remember 
this function is called ‘print formatted’? Well, the Xn is a bit of 
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Right You interact 
with both the 

C compiler and 
your compiled C 
programs from the 
command line; you 
can either do this in 
aterminal window 
in the desktop, or 
by booting your 

Pi straight to the 
command line 


[ RUNNING 
YOUR 
PROGRAM ] 


You need to 
tell Linux that 
the program 
you want 

to run is in 
the current 
directory, so 
don't forget 
the ./ before 
myprog, or it 
won't know 
where to look! 


File Edit 


formatting; it's the symbol for a newline character. So this line will 
print the string ‘Hello World!’, followed by a new line. 


Compiling your program 

Let's compile and run this. Raspbian includes a C compiler called gcc, 
so there's nothing to install; just start up Raspbian on your Pi and 
you're ready to go. Use your favourite text editor to create a file called 
hello.c, copy the program above into it, and save it. Then, from 

a terminal, go into the directory where you saved hello.c and enter: 


gcc -o myprog hello.c 


This calls the gcc C compiler with the option -o myprog, which tells 
it to create an executable output file called myprog, and to use hello.c 
as the input source code. 

If you entered your C code correctly (did you make sure the semicolon 
was there?), this should take a second or so and then return you to 
the command line. There should now be a file in the current directory 
called myprog - try running it by typing: 


./myprog 

Et voila! You should now have... 
Hello World! 

...Written in the terminal. 


That's your first C program written, compiled, and run. In the next 
chapter, we'll start using C for something a bit more useful... 
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Був ~ (9x Ser 6 m E da File Edit Tabs Help 

< Symbols |> | math.c x | 

= & Functions || ШТ include <stdio.h> ier 
Ф main ІЗІ void main (void) 


a= Я 


c=a+b; 
printf (“Тһе result of adding «d and мі is «фат, a, b, е); 


These are variable declarations: 
in C, a variable must be 
declared before you use it 


C can print the results of 
calculations to the terminal 
in formats you choose 


n some languages, you can create variables as you go along 
and put whatever data you want into them. C isn't like that: to 
use a variable in C, you need to have created it first, and at the 
You can time you create it, you have to set what type of value it's going to store. 
declare By doing this, a block of memory of the correct size can be allocated by 
multiple the compiler to hold the variable. This process of creating a variable 


variables of is known as declaration. 
the same type 


in one line, 


separated by Inte gers 


commas Бок There are several fundamental data types in C, but we'll start by 
the example 


17221222222 looking at one of the most commonly used: the int type, used 
three separate to store an integer value. 

int declarations, 

you could type И . 

inta, b = #include <stdio.h> 

E [ER 

on one line. 


[ MULTIPLE 
DECLARATIONS | 


void main (void) 


{ 


int a; 
int b = 3; 
int c; 
а - 2; 
c =a + Ы; 


printf ("The sum of adding %d апа %d is %d\n", а, Ы, с); 
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The top three lines inside the main function here are declarations. 
They tell the compiler that we would like to use variables called a, b 
and c respectively, and that each one is of type int, i.e. an integer. 
In the second line, we see an example of an initialisation at the same 
time as a declaration: this stores an initial value of 3 in the variable b. 
Note that the values of a and c at this point are undefined; you might 
assume that a variable which hasn’t had a value stored in it is always 0, 
but that isn’t the case in C. Before reading the value from a variable or 
using it in a calculation, you must store a value in it; reading a variable 
before initialising it is a common error in C. 

The next two lines do some actual work with the variables 
we have declared. 


а - 2; 


This stores a value of 2 in the variable а, which will now have this value 
until it’s changed. The reason a is called a variable is that it can vary: you 
can change its value as often as you like, but only to another integer. The 
value of a variable can change, but its type is fixed when it is declared. 


c =a + Ы; 
This line adds a to b, and stores the result in c. 
printf ("The sum of adding Xd and Xd is %d\n", а, b, c); 


This is another use of the formatted print function we saw in the previous 
chapter. Note the three 4d symbols inside the string: these are format 
specifiers, and they are how you output numbers in C. When the printf 
function is executed, each Xd is replaced by a decimal representation (d 
for decimal integer) of the variable in the corresponding position in the 
list after the string. So the first %d will be replaced by the value of a, the 
second with the value of b, and the third with the value of c. 

Compile the program above and then run it. You should see this: 


The sum of adding 2 and 3 is 5 


..in the terminal. 
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[ ARITHMETIC 
SHORTHAND ] 


C allows 
shortcuts for 
some common 
operations; 
for example, 
instead 

of typing 
a-a-c1 
you can just 
enter a++. 

Or for 

ата * 3, 
you can enter 


a *= 3 
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Floating-point numbers 

So we can add two integers together; what else can we do? One thing 
we might want to do is to use floating-point numbers: numbers with a 
decimal point. These have a different type, called float. Try changing 


ES p | the code above so instead of: 


int a; 
...you have: 
float a; 


This tells the compiler that a is now a floating-point value, rather 
than an integer. Compile and run your program. What happens? 

Oops! That doesn’t look right, does it? What has happened is that, 
while the maths is still all correct, the printf statement is now wrong; 
you're telling it to print a, which is a floating-point value, as a decimal 
integer. To fix that, change the first d in the printf function to "f, 
which is the format specifier for a floating-point number, like this: 


Below Don't forget to use %Ғ instead of %d as the print specifier 
when changing the int values to float values in the example 
[ DECIMAL ane Рр 
PLACES | !Е mathie- /home/pi - Geany, 
File Edit Search View Document Project Build Tools Help 
You can set 


the number of Gye Әх | [Sev mil 


decimal places <| Symbols |> | math.c x 


to display fora [H @ Functions | #include <stdio.h> 


floating-point @ main [3] : void main (void) 
type-specifier u 
in printf 

by putting 

a decimal c=atb; 1 

point and printf ("The result of adding %f and f is sfin", a, Б, c); 
the number 

of places 
between the % 
and the f - so —— 
% da 3f will show | 15:30:26: File перане saved. 
a float value Satis 15:30:34: File /home/pi/math.c saved. 


with three | Compiler | 15:31:02: File /home/pi/math.c saved. 
digits after the — NM | 15:31:26: File /home/pi/math.c saved. 


decimal point. line 7/13 со/12 зе:0 INS TAB  modeUnix(LF) encoding: UTF-8  fileype;C scope main 
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printf ("The sum of adding %f and Xd is %d\n", а, b, c); 


That should produce something a lot more sensible when you run it. 
This is an important lesson about C: it will do exactly what you tell it 
to, even if it makes no sense. You told it to show you a floating-point 
number as if it were a decimal integer, and the compiler assumed that 
was what you wanted, even though the result was nonsense. 

When you're working with variables, always keep track of what 
values you're putting in what types, as it’s easy to introduce errors 
by assuming a variable is of one type when it's actually another. One 
common error is to put the results of a calculation on floating-point 
values into an integer. 

Try this: make b a float as well (not forgetting to change its format 
specifier in the printf), but leave c as an int, and set the two floats 
to values with decimal points, like this: 


float a; 

float b = 3.641; 

int c; 

a = 2.897; 

с= а + Ы; 

printf ("The sum of adding %f апа %f is %d\n", а, b, с); 
You'll see a result like: 


The sum of adding 2.897000 to 3.641000 is 6 


6° That’s not right! But it’s exactly what you’ve asked for. What the 
compiler did was to add the two floating-point values together, and 


got the answer 6.538, but you then told the compiler to put that into c, 


an integer variable. So the compiler just threw away everything after 
the decimal point! If you change c to a float, and change the final %d 
to %f, you'll find it gives the correct answer. 

That gives you some idea about how C handles numbers, and how 
you can use it for arithmetic; in the next chapter, we'll look at how 
to use the results of calculations to make decisions. 
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[ REMEMBER 
PRECEDENCE | 


C obeys the 
common rules 
for operator 
precedence - 
soa = а + 2 
* 3 evaluates 
the multiply 
first and then 
adds the 
result, 6, to a. 
You can use 
round brackets 
to change 


precedence - 
а = (а + 2) 
E 

gives 3a + 6. 


I Variables & Arithmetic] MágPi | 15 


CHAPTER | HREE 
CONDITIONS & 
le eect 


[ LEARN TO CODE WITH С 1 


Wastebasket 


@ test.c - /home/pi - Geany -|ІБ||ж 


File Edit Search View Document Project Build Tools Help 


рое ё х Ber mi 44 24| v 

<| Symbols |) | teste X 

= e Functions Д #include <stdio.h> 

& main [3] E} void main (void) 

4 B 
5 int а = 0; 
8 ) ro 
3 if (a == 0) a 
8 


printf ("a is equal to On"); 
else 


printf (“а is not equal to O\n"); 


15:31:02: File /home/pi/math.c saved. 5 
Stats 1 15:31:26: File /home/pi/math.c saved. When you type a closing 
home/piimath.c saved. bracket in Geany, the 
A simple if-else structure КТТ corresponding opening 


in C, making a decision 
based on the value of ‘a’ 


bracket is highlighted to 


D INS TAB mode: Unix (Li encoding: UTF-8 filety ec E 
E) - help avoid errors 


ne of the fundamentals of any programming language is the 

ability to make conditional operations - to change the program's 

flow depending on the result of a test — and C allows you to do 
this. In this chapter, we'll look at how you test conditions within your C 
BRACKETS ] programs, and how you use the results to determine what happens next. 


In C, the mechanism for controlling flow based on testing a condition 
Curly brackets is the if-else statement. Here's a simple example: 
are used 
to group А 
together a set #include <stdio.h> 


of statements 
which always : А : 
RT void main (void) 


together. If { 

your loop or int a = 0; 
if statement 

only needs 

to execute if (a == @) 
one single { 
statement, 

you can leave 

out the curly } 
brackets after else 

the test, but 

this can make ( 

the code's printf 
purpose less 

obvious to 

a human! 


printf ("a is equal to Ө\п"); 


("a is not equal to Ө\п"); 
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[ ELSE-IF | 


You can have 
multiple else 
statements 

in one test. 
Instead of 

one simple 
else for one 
alternative, use 
else if () 
with a new 
test for each 
alternative you 
want. We'll 
look more at 
this in the next 
chapter. 


Here, the keyword if is followed by a test enclosed in round brackets, 
in this case (a == 0). If the test evaluates as true, the operations 
enclosed by the curly brackets after the test are executed. 

This example also shows the use of an else clause. At the end of the 
curly brackets around the operations which you want to execute if the 
test is true, there's an else followed by another set of curly brackets; 
these contain the operations you want to execute if the original test 
evaluated as false. 

Try compiling the code above, and change the value with which 
a is initialised to make sure it does what you expect. 


=0 
That's all fine, but what's thisa == @ all about? Surely if we want to 
know whether a is equal to 0, we just puta = 0. Why the two equals 
signs? Well, try replacing the double equals sign with a single equals 
and see what happens. 

This is a very important aspect of C syntax, and a common source of 
bugs. The equals sign is used for two different things: one is to assign 
a value to a variable, whereas the other is to test whether a variable is 
equal to a value. A single equals sign (2) assigns a variable; a double 
equals sign (==) tests a variable. 

So the statement... 


if (a == 0) 


...tests to see if a is equal to O. If it is, then the test evaluates as true, 
and the code immediately after the if is executed. 
But the statement... 


if (a - 0) 


... doesn't compare a against о at all: it just sets a to о. So how does the 
compiler decide what to do next? In this case, it just looks at the value 
of what's in the brackets; you've set a to 0, so the value inside the 
brackets is 0. 

In C, a value of 0 is equivalent to false, and a non-zero value is 
equivalent to true. So by replacing the double equals with a single 
equals, you've changed the value of a, and then you look to see if the 
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File Edit Search View Document Project Build Tools Help 
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<| Symbols |? | test.c x 
= i 1 #include <stdio.h> = 
& Functions 5 
«f main [3] 3 void main (void) 
4 1 
5 int a = 0; 
6 
7 АҒ (a = 0) 
8 1 


printf ("а is equal to On"); 


else 


printf ("a is not equal to On"); 


(ESTE '''/-— 


ж 
15:31:02: File /home/pi/math.c saved. 
Status s À 
15:31:26: File /home/pi/math.c saved. 
| Compiler | 17:19:13: File /home/pi/math.c saved. 
— M | 17:19:26: File /home/pi/test.c saved. | 


м 


line: 14/16 


encoding: UTF-8 | filetype: C 


sel:0 INS TAB mode: Unix (LF) scope: main 


col: 5 


value you’ve set a to is equivalent to true or false; neither of which IL ees sure 
: . at you usea 
were what you wanted to do! If a C program is behaving strangely, double equals sign 
check very carefully that all your tests are actually tests and not Пн ace 
. UE. . after the if, not 
assignments: this is a very easy mistake to make. asingle one! 


So == is the test to see if a value is equal to another one. 

here are other useful symbols that can be used in a test. The symbol 

=, for example, means ‘is not equal to’. The mathematical operators > 
and < are used to test for ‘is greater than’ and ‘is less than’ respectively, 
and they can also be combined with an equals sign to give >= and <=, the 
tests for ‘is greater than or equal to’ and ‘is less than or equal to’. 

You can combine tests with logical operators. The symbol && is a 
Boolean AND (i.e. test whether both sides are true), and | | is Boolean 
OR (i.e. test if either side is true). So, to execute code only if both a and 
b are о, you would use if (a == 0 8% b == Ө). To check if either 
aorbiso,youuseif (a == e || b == e). 

Similarly, you can use the operator ! as a Boolean NOT to invert the 
result of a test, soif (!(a == 0)) isthesameasif (a !- 0). 


— H 
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[ INFINITE Looping 

LOOPS | The if statement is useful for making a single decision, but what if you 
want to do something repeatedly until a test is true or false? We use a 

М7 while loop for this, and here's an example: 

loops always 

finish! If the : А 

condition you #include <stdio.h> 

test ina while 

loop never void main (void) 

evaluates to 

false, your { . 

program will int a = 0; 


sit in the loop 
forever and 
never finish. 
Ifa program 
appears to be 
doing nothing 
when you run 
it, check your 
loop tests. 


while (a < 5) 

{ 
printf ("a is equal to %d\n", a); 
а++; 

} 


printf ("а is equal to %d and I've finished\n", a); 


} 


This is very similar to an if statement, but the code in the curly 
brackets is executed repeatedly for as long as the test in the round 
brackets is true, not just once. 

So in our example code, a is initialised to 0. We enter the while 
loop, and test to see if a is less than 5, which it is, so the code inside 
the curly brackets is executed. The value of a is printed out, then we 
have one of C’s useful shortcuts to save too much typing... 

a++ is the same as a=a+1; the double plus means ‘add one to this 
variable’. Similarly, a- - means ‘subtract one from this variable’; these 
are very commonly used to count the times around a loop. The notation 
a+=1 can also be used to add a value to a variable; this also works for 
other arithmetic operators, so a*=3 multiplies a by 3, and so on. 

In the while loop, each time the code in the curly brackets has been 
executed, the test in the round brackets is repeated; if it’s still true, 
the loop code is repeated again. As soon as the test is false, execution 
continues with the line after the closing curly bracket. 

Sometimes, we might want a loop which always runs at least once 
before a test is made. We do this with a small modification to the syntax 
to create a do-while loop: 
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E , [ MORE 
#include <stdio.h> ABOUT 
void main (void) SEMICOLONS | 
{ 

int a = 0; 
do 
{ 
printf ("a is equal to %d\n", a); 
a++; 
} while (a < 5); 
printf ("a is equal to %d and I've finished\n", a); 
} 


The keyword do now goes before the curly bracket, and the while 
and test go after the closing curly bracket. When this runs, the code 
in the loop always executes once before the test; you can test this by 
running both the loop examples above with a initialised to 5 rather 
than o, and seeing how the behaviour differs. 


Left A loop 
=, (дтаврреттурі: ~ executes the same 
= = = code multiple 

Je ese TES Fep times until the loop 
test is false 


In the next chapter, we'll look at some more complex examples 
of looping and flow control. П Ше 
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ee m Wow xL 


% Menu [45] Е m ж е |ш pi@raspberry: ~ |23 ыс- /homerpi- Gea.. |E сазе с -/Љотелі 0. | 
"ii for.c - /home/pi- Geany SEE 
File Edit Search View Document Project Build Tools Help 
Буы @ x ne | 8 || 4а || 2|ъ 1 
<| Symbols |> forc X 
= @ Functions 1 #include <stdio.h> (ШІ case.c - /home/pi - Geany (new instance), - 11е |х 
2 
Ф main [3] S void main (void) File Edit Search View Document Project Build Tools Help 
4 t E x 
5 int a; БУ в ~ gx nec s|m || aja 4|[v|5 
2 ШАСЫ жыды <| Symbols |> | сазес x 
15 printf (“a is equal to sd @ Functions g B #include <stdio.h> 
H printf ("fs is equal to ^d and © main [3] 3 void main (void) = E 
4 Bb . espi 
2 LA File Edit Tabs Help 
7 switch (a) 7 
8 { 
9 printf ("а is equal to O\n"); 
10 break; 
11 сазе 1: printf (“а is equal to 1107); 
12 break; 
19) і greater than 1\n"); 
14 } 
|> 


| 14:20:58: This is Geany 1.24.1. 
14:20:58: New file "untitled" opened. 
homeypiffor.c saved. 


A for loop allows you to initialise, ШЕЕ A switch statement allows 
test, and increment the variables ЕТТТ you to choose different 
associated with a loop from ВЕД 1510253 не Momeipijcase.c saved: actions depending on multiple 
within the loop definition itself ЕН different values of a variable 


line 15/16 co:1 ве:0 INS TAB _ mode: Unix (LF) encoding:UTF-8 fileype:C ѕсоре:таіп 


The if statement and while loop described in the previous 
chapter are fairly simple control structures. In this chapter, 
we’re going to look at a few more complex structures that can 
help to make your code shorter and reduce the amount of typing you 
need to do... 

While the while loop we saw in the previous article is very useful, 
the for loop tends to be favoured by many programmers, as it puts all 
the logic controlling the loop in one place. Here’s an example: 


#include <stdio.h> 


void main (void) 


{ 


int a; 


for (а = ðO; а < 5; a++) 


{ 
printf ("a is equal to %d\n", a); 


} 


printf ("a is equal to %d and I've finished\n", a); 
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[ MULTIPLE 


INITIALISATIONS | 


This isn’t all that different from a while loop, but all of the control 
for the loop lives in the round brackets after the for keyword. This 
contains three statements, separated by semicolons: in order, these 
are the initial condition, the test, and the increment. 

a = @is the initial condition; the variable a is initialised to о at the 


start of the loop. 


a < 5 isthe test, just like in a while loop. This is checked on each 


iteration of the loop, and 
evaluates to true; as soon 


the loop code is only executed if the test 
as the test is false, execution continues after 


the curly bracket at the end of the loop code. 
a++ is the increment; this is code which is executed at the end of 
each iteration of the loop, before the test is evaluated again. In this 


case, itadds 1 to a. 


So when this for loop runs, what happens? First, a is set to о. The 


test is then checked: is a 


(which is 0) less than 5? Yes it is, so the code 


inside the curly brackets is executed, and the value 


pigraspberrypi: 


is 
ais 
ais 
is 
ais 
ais 

ійга 
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equal to 
equal to 
equal 
equal 
equal 
equal 


spberrypi: 


UBWNrO 


./myprog 


ve finished 


The output when the for loop runs is 
identical to that of the while Loop in 
the previous chapter - they both do 
exactly the same thing 
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of a is printed. Finally, the increment is applied, meaning 1 
is added to a. 

The test is then repeated. If true, the loop code is executed again, 
and the increment is again applied; this repeats over and over until 
the test is false, at which point execution continues after the closing 
curly bracket. 

In terms of what they do, for loops and while loops are pretty 
much identical; both wrap up a section of code you want to run more 
than once in some logic that controls how many times it runs. You can 
use whichever makes the most sense, or whichever looks tidiest to you! 


Switch statements 
One thing that you quite often want to do is to test a variable against 
several values, and do different things based on each of them. You can 


do this with a set of nested if statements: 
#include <stdio.h> 


void main (void) 


{ 
int a = 0; [ MULTIPLE 
INCREMENTS ] 
if (a == 0) As with 
{ multiple 
printf ("a is equal to On"); initialisations, 
you can have 
} multiple 
else if (a == 1) increments in 
{ a for loop, also 
printf ("a is equal to 1\n"); E 
H (a = 6; b 
else = 1; <test> 
3 att, b 
( *- 2).Thisis 
printf ("a is greater than An"); useful if there 
} are two or 
} more variables 


That does start to get pretty long-winded, though, so C provides 
a neater way of doing this, called a switch statement. 


that change 
consistently 
while the 
loop runs. 
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#include <stdio.h> 


{ 
int a = 0; 
switch (a) 
{ 
case 0: printf ("a is equal to On"); 
break; 
case 1: printf ("а is equal to An"); 
break; 
default : printf ("a is greater than An"); 
} 


This does exactly the same as the example above with multiple 
if statements, but is a lot shorter. So how does it work? 

The opening line consists of the keyword switch, with the name 
of a variable in round brackets. This is the variable which will be 
tested against the various cases. 

The body of the switch statement is a number of case statements. 
The variable a is compared against each case in turn; if it matches the 
value immediately after the word case, then the lines of code after 
the colon are executed. 

The final case is just called default - every switch statement 
should include a default case as the final one in the list, and this is 
the code which is executed if none of the other cases match. 

Notice that the last line in each case section is the word break — 
this is very important. The keyword break tells the compiler that 
you want to “break out” of the switch statement at this point; that 
is, to stop executing code inside the switch and to resume execution 
after the closing curly bracket. If you forget to include the break 
statements, every case after the one you wanted will execute as 
well as the one you wanted. Try it by compiling the code above 
and running it - you'll see the following in the terminal: 
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а is equal to 0 


Now remove the two break statements, so the switch looks like: 


switch (a) 

{ 
case ө : printf ("a is equal to On"); 
case 1 : printf ("a is equal to 1\n"); 


default : printf ("a is greater than An"); 


and run it again - you'll now see: 


а is equal to 0 
a is equal to 1 
a is greater than 1 


Not what you expected! This is another common bug in C code - 
forgetting the break statements in your cases can result in very unexpected 


|= casec /home/pi - Geany (hem instance) 
File Edit Search View Document Project Build Tools Help 
Бу в ~ [à х ae~ 2 6 | 
<| Symbols |» | casec x 

(f Functions ПЕ #include <stdio.h> 

$ main [3] void main (void) 
! int a = 0; 
switch (a) 
Y case 0 : printf ("а is equal to On"); 

break; 
case 1: printf ("a is equal to 1\n"); 


break; 
default : printf ("a is greater than 1\n"); 


— 15:01:02: This is Geany 1.24.1. 
| Status 15:01:02: New file "untitled" opened. 


Compiler | 15:02:53: File /home/pi/case.c saved. 


Messages) 
М. E —— —— — 
line: 15/16 col1  se:O0 INS ТАВ mode Unix (LF) encoding: UTF-8 filetype:C — scope: main 
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[ YOUR 
FAVOURITE 
LOOP... 1 


Allthree types 
of loop in С- 
while, do-while 
and for - can 
be used in 
pretty much 
any situation 
where a loop 

is needed; 


choose 


whichever 
you like. Some 
people prefer 
to use one 
type of loop 
for everything; 
others pick 
and choose 
whichever 
looks tidiest 
for each 
circumstance. 
There are no 
wrong choices! 


Left Don't 

forget the break 
statements at the 
end of each case 
in your switch 
statements! 
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[ CONTINUE ] 


The keyword 
continue can 
be used ina 
loop instead 
of break, but 
instead of 
breaking out 
of the loop, 
continue 
skips all 

the rest of 

the code in 
the current 
iteration, and 
returns to the 
test case at 
the start of the 
loop. Among 
other things, 
this can be 
useful to speed 
up your code. 


behaviour. But this can also be useful; programmers will sometimes 
Structure a switch statement with code that they want to execute in 
multiple different cases, and deliberately leave out the break statements. 


Leaving a loop early 
The break statement has one other use; it can be used inside while 
and for loops to break out of them. Look at this example: 


&include «stdio.h» 


void main (void) 
{ 


int a = 0; 


while (1) 
{ 
printf ("a is equal to %d\n", a); 
а++; 
if (a == 5) 
{ 
break; 
F 
} 
printf ("a is equal to %d and I've finished", a); 


} 


So we have a while loop in which the test is just the value 1; this is 
a non-zero value, and so is always true. If you enclose code inside curly 
brackets after awhile (1) statement, the loop will never end; it will 
keep running forever. But in this case we have provided an alternative 
way to end the loop; we test the value of a inside the loop itself in an 
if statement, and if a is equal to 5, we call break. This causes the loop 
to end and execution to continue with the statement after the loop. A 
break statement like this can be useful to leave a loop early in the event 
of an error, for example. 
That’s about all you need to know about control flow in C; in the next 
chapter, we'll look at pointers, which are one of C’s most useful and 
powerful features. 
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File Edit Search View Document Project Build Tools Help e 
A declaration for a pointer to an 


“ “А > % Е: А à : 
Grey 5910 х 3%9- «| да integer variable - effectively ап 
- l pate : 

f Symbols |> [рос x | address containing an integer 

£ #include <stdio.h> 
(9 Functions 2 
«9 main [3] 3 void main (void) 

4 
5 int a; 
6 int *ptr to a; 
7 
8 ptr to a = &a; 
9 
10 


a-25; 
printf ("The value of a is d\n", a); File Edit Tabs Help 


*ptr to a = 6; 


printf ("The value of a is “din”, a); 


printf (“Тһе value of ptr to a is %d\n", ptr to a); 
printf ("It stores the value %d\n", *ptr to a); 
printf ("The address of a is %d\n", &a); 


10:25:42: File /home/pi/sum.c saved. 


2 10:26:16: File /home/pi/sum.c saved. 
Compiler | 10:26:23: File shome/ni/sum.c saved 


An assignment of a pointer - 
initialises the pointer to point ; 
at a specific variable ode: Unix (LF) 


encoding: UTF-8 — filetype: С 


he term pointer has struck fear into the heart of many a 


[* AND & ] beginner C programmer, but once you’ve got your head around 
them, they are a very useful feature of the language. They 

When I was $ ; ; А eps 

first learning aren’t actually that complicated in reality, but it’s easy to get confused 

about pointers, when using them, so let’s try to avoid that... 

Kien it Remember when we looked at the declaration of variables? Declaring 

Ваа a variable — telling the compiler what type it is and what it’s called — 

a line of code before you can use it is necessary in C, because the declaration enables 


Rerum an the compiler to allocate a block of memory to store the variable. So for 
E every variable you declare, there's a block of memory which is set aside 


pointed to by", . 4 : І 
and an &is “the by the compiler for that variable, and the compiler remembers which 


address of”. particular block of memory is used for each variable. 

Once you've 

oe What is a pointer? 

fixed in your A pointer is just the address of a block of memory with a variable in it; 

doen de that's all there is to it. So if you declare a variable and a pointer to that 
understood variable, you can access the value in that block of memory in two ways; 
pointers! either with the variable name, or with the pointer. 
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Let’s look at a simple example: 
#include <stdio.h> 


void main (void) 


{ 
int a; 
int *ptr_to_a; 
ptr_to_a = &a; 
а = 5; 
printf ("The value of a is %d\n", а); 
*ptr_to_a = 6; 
printf ("The value of a is %d\n", a); 
printf ("The value of ptr_to_a is %d\n", ptr_to_a); 
printf ("It stores the value %din", *ptr to a); 
printf ("The address of a is %d\n", &a); 
} 


Taking it line by line, the first line is one we’re already familiar with: 
we declare an integer variable called a. But what’s this? 


int *ptr_to_a; 


This looks like it’s declaring another integer variable, doesn’t it? 
But look more carefully; the asterisk (*) at the start of the variable name 


indicates that this is not declaring an integer variable, but a pointer to an | І Е | 
integer variable. 


So we now have an integer variable called a, and we have a pointer to 


an integer variable, called ptr_to_a. But neither of these actually have 
a value in them yet: they are both uninitialised. It’s all very well calling 
the pointer ptr to a, but it has no idea what (or where) a is, so we'll 
fix that with the next line. 


ptr_to_a = &a; 
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Pointers are 
one of the 
ways C allows 
(or in some 
cases forces) 
you to think 
about what 
the actual 
hardware 

of your 
computer is 
doing - a good 
understanding 
of pointers 
gives you 

a good 
understanding 
of how the 
compiler 
handles 
memory. 


This is the important bit! In C, the symbol & before a variable name 

means address of the variable, so &a means “the address in memory 

of the variable a”. And as we said above, a pointer is the address of a 

variable. So this line initialises ptr_to_a to be the address of a; ptr_ 

to_a is nowa valid pointer to the variable a, so we can now use it. 
The next two lines are familiar; we set a to be 5, and just to check 

that worked, we print its value. So let’s try doing the same thing, 

but with the pointer. 


*ptr_to_a = 6; 


That asterisk again, but used in a slightly different way from 
before. When declaring a variable, putting an asterisk before its name 
indicates that the variable is a pointer. But once the pointer exists, 
putting an asterisk in front of its name means the variable pointed 
to by this pointer; this is known as dereferencing the pointer. So this 
line tells the compiler to set the variable pointed to by the pointer 
ptr_to_a to 6. We know that the variable pointed to by ptr_to_a is 
a; we set that up a couple of lines back, and so this line is just another 
way of setting a to 6; indeed, if we print the value of a, we find it has 
changed to 6. 

The next lines will hopefully help you get the relationship between 
pointers, variables, and addresses clear in your mind. 


printf ("The value of ptr_to_a is %d\n", ptr_to_a); 

In this line, we’re printing the value of ptr_to_a; not the 
value it’s pointing at, but the value of the pointer itself. This 
prints a very large number, as it’s the address in memory where 
a can be found. 


printf ("It stores the value %d\n", *ptr_to_a); 


In this line, we’re printing the value pointed to by ptr_to_a; note 
the asterisk before the name. This prints the value of a. 


printf ("The address of a is %d\n", &a); 
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Finally, in this line we’re printing the address of a itself; 
note the & sign before the name. Again, this prints a very large 
number, the same as the value of ptr_to_a we printed above. 

The crucial thing to remember when working with pointers is 
this: you can’t just declare a pointer, as you need to also declare 
and associate the variable you want it to point to. When a pointer is 
created, it points at a random location in memory; if you try and write 
something to it, you can cause all sorts of errors up to and including 
crashing the computer completely! Always make sure your pointers 
are pointing at something before doing anything with them. 


UE boo 


File Edit Tabs Help 


[ ALWAYS 
HAVE 
SOMETHING 
TO POINT TO! ] 


pi@raspberry 


Above The example code shows clearly the relationship between a pointer and the 
actual address in memory of a variable - note that the address of a is identical to the 
value of the pointer. (The actual address will probably be different when you run the 
code, but the pointer and the address will still have the same value.) 


Void pointers and casting 

You can also define a pointer without saying what type of variable it’s 
pointing to; this is a void pointer, written as void *. If you think about 
it, this makes sense; a pointer is just an address in memory, so we 
don’t necessarily need to know what is at that memory. To use a void 
pointer, you need to cast it; you tell the compiler what sort of pointer 


to treat it as, and what sort of variable is in memory at that location. 
Here’s an example: 
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#include <stdio.h> 


void main (void) 

{ 
int intval = 255958283; 
void *vptr = &intval; 


printf ("The value at vptr as an int is %d\n", *((int *) vptr)); 
printf ("The value at vptr as a char is %d\n", *((char *) vptr)); 
h 


We initialise the void pointer vptr to point to an integer variable 
called intval. 

In the first printf statement, we insert (int *) in front of vptr 
before we dereference it using *. This casts vptr to an integer pointer, 
and so the value of intval is printed as an integer. 

In the second printf statement, we insert (char *) in front of vptr 
before we dereference it. This casts vptr to a char pointer, and so what’s 
printed is the value of the char which makes up the first byte of intval. 


[ INCREMENTING 

POINTERS ] What do you use pointers for? 

ES That's really all there is to pointers, other than to ask why bother? 
++and -- on We can already access a variable with its name, so why do we need 
pointers, but to have some complicated alternative way of getting to the contents 


you need to of a variable? 
be careful. ; ; 3 r ) 
(*а)++ There are several ways in which pointers are useful, which we will 
increments explore in more detail in later chapters. But a few of the important 
the value 

ones are: 
pointed to by 
a, but * (a++) 
increments > function calls - in the next chapter we will look at how to split up C 
the pointer code into functions; pointers are very useful for allowing a function 
itself rather ) 
than the value to return multiple values. 
it points at - > string handling - in C, a string is a continuous block of memory with 
еи a letter stored in each byte; pointers make it possible to perform 
the memory efficient operations on strings. 


address > arrays — C allows array variables, lists of values of the same type, 
wares which like strings are stored in a continuous block of memory; 
* pointers make accessing arrays easier and more efficient. 
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Functions - how to split your code 
up into easy bite-sized chunks 


D 


ket 


“И Тһе 1 
Е шж 0 


3p func.c - /home, 


+! Jfunc.c - /home/pi - Ge.. = pi@raspberry: ~ 


File Edit Search View Document Project Build Tools Help A function definition consists 


Gy ey B х ze~ £|8 ца of a return type, a function 


ESG IT name, and a list of arguments 
Symbols |? | func.c X 2 
- enclosed іп round brackets 
«fo Functions i #include 
«f main [11] 3 ігі sum_and_diff (int а, int Б, int *res) 
4 B 
«9 sum and diff | 5 int sum; 
6 sum = a + b; 
7 *res = a - Б; 
8 return sum; E S 
9 L} Pi@rasphery: = 


void main (void) File Edit Tabs Help 
{ pr I 


int b = 2; 

14 int diff; 

15 

16 printf ( 1 j , Б, sum and diff (5, b, &diff)); 
printf ( if r f |", b, diff); 


A function must return a 
value of the same type 
as stated in its definition 


lin 13/19 col 14 ве:0 INS TAB  modeUnix(LF) encoding UTF-8  filetype C 


Scope: main 


puntil now, all the examples we've looked at have had one 


[ ARGUMENTS ] single function, main, with all the code in it. This is perfectly 


valid for small, simple programs, but it's not really practical 
once you get more than a few tens of lines, and it's a waste of space if 
you need to do the same thing more than once. Splitting code up into 
separate functions makes it more readable and enables easy reuse. 
We've already seen functions used; the main function is a standard 
C function, albeit with a special name. We've also seen the printf 
function called by our examples. So how do we create and use a 
function of our own? Here's an example: 


#include <stdio.h> 


int sum (int a, int b) 
int res; 
res = a + b; 
return res; 
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void main (void) 
{ 
int y = 2; 
int z = sum (5, y); 


printf ("The sum of 5 and %d is %d\n", y, Z); 
} 


This includes both the main function and a second function called sum. 
In both cases, the structure of the function is the same: a line defining 
the value returned by the function, the function name, and the 
function arguments, followed by a block of code enclosed within curly 
brackets, which is what the function actually does. 


What's in a function? 


Let’s look at the sum function: 
int sum (int a, int b) 


The definition of a function has three parts. The first part is the type 

of the value returned by the function: in this case, an int. The second 

part is the name of the function: in this case, sum. Finally, within round 

brackets are the arguments to the function, separated by commas, and 

each is given with its type: in this case, two integer arguments, a and b. 
The rest of the function is between the curly brackets. 


int res; 


This declares a local variable for the function, an integer called res. 
This is a variable which can only be used locally, within the function 
itself. Variables declared within a function definition can only be used 
within that function; if you try and read or write res within the main 
function, you'll get an error. (You could declare another int called 
res within the main function, but this would be a different variable 
called res from the one within the sum function, and would get very 
confusing, so it's not recommended!) 
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[ VARIABLE 
SCOPE ] 


If you declare a 
variable within 
a function, it's 
only usable 
within that 
function, not 
within any 
functions 
which call 

the function, 
or within 
functions 
called by the 
function. This 
is known as 
the scope of a 
variable: the 
parts of the 
code in which 
it's valid. 
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res = а + b; 


This should be obvious! Note that a and b are the two defined arguments 
of the function. When a function is called, a local copy of the arguments 
is made and used within the function. If you change the values of a or 
b within the function (which is a perfectly valid thing to do), that only 
affects the value of a and b within this function; it doesn’t change the 
values that the arguments had in the function from which it was called. 


return res; 


Finally, we need to return the result. The function was defined to 
return an integer, so it must call the return statement with an integer 
value to be returned to the calling function. 

A function doesn’t have to return a value; if the return type 
is set to void, it returns nothing. There's no need for a return statement 
in a function with a void return type; the function will return when it 
reaches the last line; however, if you want to return early (in the event 
of an error, for example), you just call return with no value after it. 


Calling a function 


Let's look at how we call the function from main: 


int z = sum (5, y); 


= pi@raspberypi: = 
File Edit Tabs Help 


Above The main function prints out the values returned by the sum function 
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The sum function returns an integer, so we set an integer variable 
equal to it. The arguments we supply to the function are inside round 
brackets, and in the same order as in the function definition; so in this 
case, a is 5, and b is the value of y. 

Can you return more than one result from a function? You can only 
return one value, but you can also use pointers to pass multiple items 
of data back to the calling function. Consider this example: 


#include <stdio.h> 


int sum_and_diff (int a, int b, int *res) 
{ 

int sum; 

sum = a + Б; 

*res = а - b; 

return sum; 


void main (void) 
{ 

int b = 2; 

int diff; 


printf ("The sum of 5 and %d is %d\n", b, 
sum and diff (5, b, &diff)); 
printf ("The difference of 5 and Xd is %d\n", b, diff); 
) 


We've modified the sum function to calculate both the sum 
and the difference of the arguments. The sum is returned as before, 
but we're also passing the difference back using a pointer. Remember 
that the arguments to a function are local variables; even if you 
change one in the function, it has no effect on the value passed by the 
calling function. This is why pointers are useful; by passing a pointer, 
the function doesn't change the value of the pointer itself, but it can 
change the value in the variable to which it's pointing. 

So we call the function with the same two arguments as before, but 
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we add a third one, a pointer to the variable where we want to write 


[ MODIFYING the difference calculated by the function. In the function, we have 
ARGUMENTS ] 


this line: 


*res = а - Б; 


The difference is written to the variable to which res is a pointer. 
In the main function, we call the sum_and_diff function like this: 


sum_and_diff (5, b, &diff) 
We provide the address of the integer diff as the pointer argument 


to the sum_and_diff function; when the difference is calculated, it’s 
written into the variable diff in the main function. 


авррелур = LJEJEJ 
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Right By using 

a pointer as one 
argument, the 
sum and diff 
function can 
return both 

the sum and 
difference of the 
arguments 


Order matters 

One thing to bear in mind when defining functions is that the compiler 
reads files from top to bottom, and you need to tell it about a function 
before you can use it. In the examples above, this is automatic, as the 
definition of the sum and sum and diff functions is before the first 
call to them in main. 
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But in larger files, when multiple functions call multiple other 
functions, this gets complicated; it's not always easy to make sure the 
function definitions are allin the right order. To avoid this, C allows 
you to declare functions before they are used. 

A function declaration is just the definition of the function, minus 
the function code within the curly brackets. So for the sum_and_diff 
function, the declaration would be: 


int sum_and_diff (int a, int b, int *res); 

Note the semicolon at the end! Function declarations are included at 
the top of the file; when the compiler finds a function declaration, it 
knows that at some point a function with this name, arguments, and 


return type will be defined, so it then knows how to handle a call to it, 
even if it hasn’t yet seen the definition itself. 
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How to handle arrays (lists of values) 
and strings (lists of letters) in C 


[ LEARN TO CODE WITH C 1 
[1 Menu a) Е m ж Q Ы pi@raspberry: ~ | бапаус- Љоте/рі-6..| 
9 "80 array.c - /home/pi - Geany -||в|% 
File Edit Search View Document Project Build Tools Help 
Wastebasket ——— —_, 
ЕН >< ы + @ x ey |i aja || 2|%| 
< Symbols > | array.c х 
Brincos | 1 #include <stdio.h> 
main [3] 


void main (void) 
at 


int a[10]; 
int count; 


for (count = 0; count « 10; count++) 


alcount] = count * 10 + count; 
pigraspbe 


printf ("The first and second elements of a are % and %“d\n", alo], a[1]); |File Edit Tabs Help 


printf ("Ог, as pointers, % and %d\n", жа, *(a*1)); 


An array can be accessed 
by its indices inside square 


An array declaration, showing 
the type, the name, and the 
number of elements == — brackets, or as a pointer 


E E IE EE E E 


he variables we have looked at so far are all single numeric 
values. In this chapter, we’re going to look at how C handles 
lists of values, and that leads into using lists of letters to store 
and manipulate text strings. 

An array is a single variable which stores multiple different values of the 
same type; the individual values are accessed by indexing the array. An array 
can have one or more dimensions; a one-dimensional array is a single list of 
values, while a two-dimensional array is a list of lists of values, and so on. 

An array is declared in C by putting the size of each dimension in 
square brackets after the variable name. So 


int a[10]; 
is a list of 10 integers, while 
int b[5][6]; 


is a list of 5 lists, each of which contains 6 integers. 

When accessing the elements inside an array, the array index - the 
number inside the bracket - starts at O. So the 10 integers contained within 
array a above are referred to as a[@], a[1], а[2] and soon up to a[9]. The 
compiler will quite happily allow you to read or write a[10], a[11] or indeed 
a[any number you like], but these are all outside the memory which was 
allocated when the array was declared, so writing to them is a really bad idea! 
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[ KEEP INSIDE 
YOUR ARRAY ] 


One of the 
nastiest 
Sources of 
crashes and 
bugs in C is 
creating an 
array and then 
writing past 
the end of it. 
The compiler 
won't stop 
you writing 
to memory 
off the end of 
an array, and 
doing so can 
have serious 


consequences. 


Always make 
sure your 
array indices 
fit inside 
your array. 


Arrays and pointers 

This brings us on to the relationship between pointers and arrays. 

The name of an array is effectively a pointer to the first element of the 
array. Remember that a pointer is the address of a variable in memory? 
Well, an array is a contiguous block of memory which contains all the 
elements of the array in order, so you can use a pointer to access it. (In 
fact, even if you use values in square brackets to access it, the compiler 
treats those as a pointer anyway.) Here's an example: 


&include «stdio.h» 


void main (void) 
{ 

int a[10]; 

int count; 


for (count = @; count < 10; count++) 


{ 


a[count] = count * 10 + count; 


printf ("The first and second elements of a are %d and %d\n", 
a[@], a[1]); 
printf ("Or, as pointers, %d and %d\n", *a, *(a+1)); 


This fills the 10 values of a with the numbers 0, 11, 22, 33, and 
so on, and then reads a[0] and a[1]. It then reads the same values 
using a as a pointer, and you can see if you run the code that they 
are identical. 

With a two-dimensional array or greater, you need to consider 
how the compiler arranges the dimensions in memory; it does so by 
grouping the elements at the rightmost index of the array together. 
With the array b[5][6] above, b itself points at b[0][0]. b+1 points 
at b[@][1]; 6+5 points at b[0][5]; and b+6 points at b[1][0]. 

You can initialise an array at the same time as you declare it by 
putting the values in curly brackets, so: 
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int a[10] = { 0, 11, 22, 33, 44, 55, 66, 77, 88, 99 }; 


But note that this only works when the array is first declared; once it 
exists, you can’t use this shortcut and will need to iterate through the 
array indices, setting each value in turn. 


а[о] a[i] а[2] a[3] a[4] а[5] а[6] a[7] а[8] al9] 


Ы0101 | b[O][1] | b[OJ2] | МОІЗІ | b[O]JA] | b[OJS] | b[1]0] | ЫЛІПІ | ЫЛІРІ | b[1]3] 


Above Array elements are stored sequentially in memory, with the array name a 
pointer to the first element. Multi-dimensional array elements are stored with the 
elements with neighbouring values, in the rightmost index next to each other 


Strings 
In C, a string is just another array; it's an array of single characters. A character 
is a specific type in C, called char; this holds a single byte, which is enough to 
hold an alphanumeric character. So a string with ten bytes would be: 


char mystring[10]; 

Or, to initialise it at the same time: 
char mystring[10] = "thestring"; 

One important thing to remember is that a string in C must always 
end with a byte set to zero, and that the memory required to hold this 


final zero (called the string terminator) must be allocated when you 
declare the string. So mystring, which is declared as an array of 10 
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[ NAMES ARE 
POINTERS ] 


Remember 
that the name 
of an array ora 
string is just a 
pointer to the 
first element 
of the array 

or string in 
question, and 
can be used 
in the same 
way as any 
other pointer; 
it can be 
incremented 
and 
decremented, 
or 
dereferenced 
to find the 
value to which 
it points. 


Below Strings 
are stored as an 
array of single 
characters, with 
the element after 
the last character 


chars, can only actually hold text of 9 or fewer letters. set to zero 
mystring 
е m e e Ф p т x g 0 
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Always 
remember that 
the memory 
you allocate 
for a string 
needs to be 
long enough 
to hold all the 
characters, 
plus one extra 
to store the 
terminating 
zero. If you're 
manipulating 
strings yourself 
with pointers, 
make sure you 
remember to 
write the zero 
at the end 

of any string 
you create. 


You can use the index in square brackets to access individual 
characters in a string, or you can use a pointer. Here’s an example 
of using pointers to join two strings together: 


#include <stdio.h> 


void main (void) 


{ 


char str1[10] 
char str2[10] 
char str3[20]; 


"first"; 
"second"; 


char *src, *dst; 


src = strl; 
dst = str3; 
while (*src != 0) 
{ 
*dst = *src; 
src++; 
dst++; 
} 
src = str2; 
while (*src != @) 
{ 
*dst = *src; 
src++; 
dst++; 


} 
*dst = 0; 


printf ("Xs + Xs = %s\n", 51г1, str2, str3); 


First, we create two strings - str1 is “first” and str2 is “second” - 
and we allocate an empty string, str3, to put the result in. 

We then create a pair of char pointers, and point src at the 
start of str1 (the “f” of “first”) and dst at the start of the empty 
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str3. We then loop, copying what’s at src to dst, and then 
moving both pointers forward by one, until we find the zero that 
terminates str1. 

We then point src at str2, and do the same thing again, until we 
find the zero at the end of str2. Finally, we write a zero to the end 
of str3 to terminate it. Note the new format specifier used to print 
strings; %s is used to print a string, and will display every character 
from the pointer supplied as an argument, up to the first terminating 
zero it finds. (If you want to print a single character, you can use the 
format specifier %c.) 


Writing to strings 
Because the name of a string variable is only a pointer to the first 
character of the string, you can’t just use an equals sign to set the 
value of a complete string. You can initialise a string variable at the 
time you declare it, as above, but what if you want to set or change 
it later? 

There are a few ways to do this, but the most useful is the sprintf 


function; this is a version of the printf function we have already seen, 


which writes arbitrary text to string variables. The only difference 
is that the first argument it takes is the name of a string variable, 
and it writes to that instead of to the terminal: 


#include <stdio.h> 


void main (void) 
{ 
int val = 12; 
char string[50]; 


sprintf (string, "The value of val is %d\n", val); 
printf ("%s", string); 
} 


The sprintf function will automatically add the terminating zero 
at the end of any string you create with it. 

In the next chapter, we'll look at some of the functions provided 
in C's string handling library to make working with strings easier. 


[ LEARN TO CODE WITH C ] 


[ KEEP INSIDE 
YOUR STRING ] 


As with arrays, 
it's even easier 
to write off the 
end of a string 
and to corrupt 
memory 
elsewhere as 
aresult. If in 
doubt, declare 
your string 
variables with 
more space 
than you think 
you'll need, 
and make 
sure that what 
you're writing 
into them 
actually fits. 
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#include <string.h> 
«9 main [4] 


char stri[10] 
char str2[10] 
char str3[20]; 


firsts. 
"second"; 


File Edit Tabs Help 


strcpy (str3, str1); 
strcat (str3, str2); 


printf ("ss + %s = %s\n", strl, str2, str3); 


strcat is the library function 
to concatenate two strings 


15:43:16: File /home/pifstring.c opened(2). 


n the previous chapter, we saw how to access strings using 
pointers. This works perfectly well, and gives you a good 
understanding of how pointers work, but it’s a bit long- 
winded. Fortunately, C provides a library of useful string functions, 
which save a lot of typing! 

In the last chapter, we saw how to join two strings together using 
pointers. We’re going to do the same thing using the string handling 
library. Here’s the code rewritten using string library functions: 


[ KEEP INSIDE 
YOUR STRING] 


The string 
library #include <stdio.h> 


functions won't г z 
generally #include <string.h> 


prevent you 

from writing void main (void) 
off the end of " 

a string; just 


as when using char str1[10] = "first"; 
вопас теи char str2[10] = "second"; 
using library . 

functions you char str3[20]; 

still need to 

make sure strcpy (str3, str1); 


your string 
variables are 
large enough 
for the values printf ("Xs + Xs = %s\n", stri, str2, str3); 
you're writing 

into them. 


strcat (str3, str2); 
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That's a lot shorter! Note the #include <string.h> at the start, which 
tells the compiler we want to use functions from the string library. 

This shows us two string functions. strepy (‘string copy’) copies 
the string at the second argument to the start of string at the first 
argument. strcat (‘string concatenate’) does the same thing, but 
instead of copying to the start of the first argument, it finds the 
terminating zero of the first argument and starts copying to its 
location, thus joining the two strings together. 


Comparing strings 
Another common requirement is to be able to compare two strings 
to see if they are the same. As we’ve already seen, we can compare 
numeric values with the == operator, but this doesn’t work with 
strings. Remember that the name of a string is really just a pointer 
to a location in memory containing the string, so using == to compare 
two strings will only tell you if they’re at the same place in memory, 
not if two strings at different locations are the same. 

You can use == to compare two char variables, and a string is an 
array of chars, so it’s possible to write a simple piece of code that 
compares each character in a string in turn: 


#include <stdio.h> 


void main (void) 

{ 

char str1[10] "first"; 

char str2[10] "fire"; 

char *ptr1 = stri, *ptr2 = str2; 


while (%рігі != 0 8% *ptr2 !- 0) 
{ 
if (*ptri !- *ptr2) 
X 
break; 
) 
ptri++; 


ptr2++; 
} >> 
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DON'T 
>> if (*ptri == Ө && *ptr2 == Ө 
Р Cp P ) OVERWRITE ] 
printf ("The two strings are identical. An"); It looks like it 
) ought to be 
possible to 
else use strcpy 
{ and strcat 
printf ("The two strings are different.\n"); to copy part of 
a string over 
} itself - strcpy 
} (а + 1, a), 
for example. 
) ; Р : : : Dont try it! The 
But that's a bit tedious to write out every time, so the string library ES E 
has done this for you with the function stremp (for ‘string compare’). destination 
Here's how you use it: buffers for 
strcpy and 
strcat must 
#include <stdio.h> be completely 
#include <string.h> separate areas 
of memory; 
if not, their 
void main (void) behaviour is 
{ unpredictable. 
char str1[10] = "first"; 
char str2[10] = "fire"; 


if (strcmp (stri, str2) == 0) 


{ 

printf ("The two strings are identical.\n"); 
} 
else 
{ 

printf ("The two strings are different.\n"); 
} 


strcmp takes two strings as arguments, and returns a 0 if they’re the 
same; it returns a non-zero value if not. 


What about if you just want to compare the first few characters of a 
string, not the whole string? There's a library function for that, too: 
strncmp (for ‘string numbered compare’). E Е RE Em 
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There are 
versions of 
strcmp and 
strncmp 
which ignore 
the case of the 
letters in the 
strings being 
compared; 
they're called 
strcasecmp 
and 
strncasecmp, 
respectively. 
They take 

the same 
arguments 
and return the 
same values. 


This works in exactly the same way as strcmp, but it takes a third 
argument, an integer giving the number of characters to compare. 
So strncmp ("first", "fire", 4) would return a non-zero value, 
while strncmp ("first", "fire", 3) would return a 0. 


Reading values from a string 

We saw in the previous chapter that we can use sprintf to write 
variables into a string; what about being able to read variables back out 
of a string? The function sscanf ('string scan formatted") does that for 
you. Here's how it works: 


#include <stdio.h> 


void main (void) 


{ 

int val; 

char string[10] = "250"; 

sscanf (string, "%d", &val); 

printf ("The value in the string is %d\n", val); 
Т 


sscanf uses exactly the same format specifiers as printf. 

One important difference, though, is that the arguments to sscanf 
must all be pointers to variables, rather than variables themselves. As 
always, a function can never change the values of variables provided 
as arguments, but it can write to their destinations if they are 
pointers. 

You can check whether sscanf was able to match the format 
specifiers with the string provided by looking at the value it returns; 
sscanf returns the number of values it successfully read. So for 
example, if a format specifier of %d is provided but the string supplied 
doesn’t start with a decimal number, sscanf will write nothing to the 
supplied pointer and will return 0; if the string supplied does start with 
a decimal number, sscanf will return 1. 
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The format string supplied to sscanf can contain multiple format 
specifiers and even other text: 


&include «stdio.h» 


void main (void) 


{ 
int val; 
char result[10]; 
char string[25] = "The first number is 1"; 
if (sscanf (string, "The %s number is %d", result, &val) == 2) 
{ 
printf ("String : %s Value : %d\n", result, val); 
} 
else 
{ 
printf ("I couldn't find two values in that string.\n"); 
} 
} 


Note that, slightly inconsistently, the %s format specifier denotes a 
pointer to a string in both printf and sscanf, while the %d specifier 
denotes a variable in printf but a pointer in sscanf. 

One thing to note about sscanf is that it’s in the standard I/O 
library, not the string handling library, so you don’t need #include 
<string.h> to use it. 
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%d format specifier 
to read the 
decimal value 250 
out of a string 


[ SSCANF 
STRINGS ] 


[The String Library] MágPi | 53 


The e 


ESSENTIALS 


!stríng;c-/home/pl- Geany 
File Edit Search View Document Project Build Tools Help 


LEM ey 2 x Ser glm] dla || 4| e| B 

<| Symbols |> | array.e X | string.c X 

- 2$ Functi 104 
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Ф main [4] 106 
107 void main (void) 
108 CD 
109 int val; 
110 char result[10]; 
111 char string[25] - "The first number is 1"; 
112 
113 if (sscanf (string, "The %s number is sd", result, aval) == 2) 
114 
115 printf ("String : %s Value : %d\n", result, val); 
116 j 
117 else 
118 1 
119 printf ("I couldn't find two values in that string. An"); 
120 H 
121 J 
EA AAA 2 
Za ESRI Pie тоте pr SOng C OPENEN). = 
| 15:43:47: File /home/pi/string.c saved. 1 | 


line:128/142 со:0 <е:0 INS TAB mode: Unix (LF) encoding: UTF-8  filetype:C scope: unknown 


Above sscanf How long is a (piece of) string? 
reads numeric 
values and words Опе final useful string handling function is strlen (for ‘string length"); 
outofaformatted а5 the name suggests, this tells you how many characters there are in a 
string, allowing ? 
youtoparsetext string, counting from the start to the terminating zero character. 
from elsewhere. 
Remember that 
allthe arguments include <stdio.h> 


а #include <string.h> 
e pointers 
void main (void) 
{ 

char str1[10] = "first"; 


printf ("The length of the string '%5' is %d\n", str1, 
strlen (str1)); 


All the operations we've looked at here are possible by manually 
manipulating pointers; the string library just makes them easier and 
will make your code shorter. If you find yourself moving pointers 
around strings in a program, always check the string library to make 
sure you're not reinventing the wheel! 
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«f main [3] ІТЕ void main (void) 
4 Bt 
5 char input[256], name[256] ; 
6 int age; 
7 
8 printf ("What is your name, иѕер?\п"); 
9 fgets (input, 256, stdin); 
10 sscanf (input, "%5", name); 


printf ("Hello, %s. How old are) you?\n", name); File Edit Tabs Help 
pus (1) ; g 


fgets (input, 256, stdin); 

if (sscanf (input, "%0", &age) == 1) break; 

17 printf ("That wasn’t anything I recognise as an 
} 


20 printf ("well, %s, you look young for %d...\n", name 
2. 


14:36:03: This is Geany 1.24.1. 
[| Status 14:36:03: File /home/pi/input.c opened(1). 
| compiler | 14:37:20: File /home/pi/input.c saved. 


| 14:37:49: File /home/pi/input.c saved. 
Лоссапос| 
меа. 


fgets is the library function 
to read text from an input 
stream 


mode: Unix (LF) encoding: UTF-8 "filetype: q 


n the previous chapter, we looked at how to print program 
output to the terminal, but in order to interact with the user, 
this needs to be a two-way process. This chapter looks at how 
we can read and interpret input that the user enters in the terminal. 

We’ve seen the printf function used a lot in previous chapters; it’s 
the standard way of writing formatted text output from a program to 
the console, the command line from which you run the program. But 
what if you want to get input from the user? How do we read what the 
user types into the console? 

In the last chapters, we looked at the sscanf function which 
reads values from a string. There’s an equivalent function called 
scanf, which reads values directly from the console, as in the 
following example: 
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#include <stdio.h> 


void main (void) 
{ 
char input[256]; 
int age; 


printf ("What is your name, user?\n"); 
scanf ("%s", input); 


printf ("Hello, %s. How old are you?\n", input); 
scanf ("%d", &age); 


printf ("Well, %s, you look young for %d...\n", input, age); 


scanf works exactly like sscanf, but has one fewer argument, 
as it reads from the console rather than from a string. 

However, it’s not really the best way of getting console input; it 
only really works if you have a user who types in exactly what you 
expect. Unfortunately, users have a nasty tendency to type in things 
you aren’t expecting, and scanf doesn’t cope well with this. For 
example, in the code above, if the user types in 257 characters when 
asked for their name, they will overflow the space allocated for the 
input string, and bad things may happen... 
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A better way 

A better approach is to read each line the user enters into a 
buffer string, and then use sscanf to read values from that 
string. The C library function fgets is useful for this. Have a look 
at this example: 


#include <stdio.h> 


void main (void) 


{ 

char input[256], name[256]; 

int age; 

printf ("What is your name, user?\n"); 

fgets (input, 256, stdin); 

sscanf (input, "%s", name); 

printf ("Hello, %s. How old are you?\n", name); 

while (1) 
[ STDIN ( 
AND STDOUT ] fgets (input, 256, stdin); 
We talk about if (sscanf (input, "Xd", &age) -- 1) break; 
stdin in this printf ("I don't recognise that as an age - try again!\n"); 
article, which is } 
the ‘standard 
input’ stream: 
what the printf ("Well, %s, you look young for %d...\n", name, age); 
user types at } 
the console. 
You may mE І ио 
sometimes see fgets takes three arguments. The first is the buffer into which it 
е should store the input. The second is ће maximum number of bytes 
Еау it will write into that buffer; this is useful to prevent the overflow 
output’ stream situation mentioned above. Finally, it takes an argument telling 
- as you Mc it where to read from; in this case, this is set to stdin (short for 
Е ‘standard input’), which tells it to read from the console. 
is printed to So each time we ask the user for input, we use fgets to read up to 256 
the console, characters of whatever they type (up to the point at which they press 


usually 
via printf. 


the enter key), and we then use sscanf to interpret it. Additionally, 
when asking for the user’s age, we use the value returned by sscanf 
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(described in the previous chapter) to check that the user has entered 
what you expect, and loop until they give a valid answer. You can use 
this method to interpret pretty much anything a user types, and to 
safely handle all the cases where they type something unexpected! 


Reading parameters 
There’s another way to get input to your program, which is to supply 
it as a parameter when you start the program from the command line. 
At this point, I have to admit to not having been entirely honest for 
the last 8 chapters... I’ve always shown the definition of the main 
function as 


void main (void) 


This works, as you’ve seen, but it isn’t strictly correct. The strict 
definition of main looks like this: 


int main (int argc, char *argv[]) 


But let's be honest: if Pd shown you that in chapter 1, you'd have run 
a mile, wouldn't you? So what does it all mean? 

First off, we can see that main returns an integer; this isa 
success or failure code which some operating systems can use for 
processing in a shell script or the like. Traditionally, if a program succeeds, 
main returns 0, and if it fails, it returns a non-zero error code. For 
programs that run on their own, you really don't need to worry about it! 

What's more useful are the other two arguments. argc is an integer, 
and this is the number of parameters which were provided on the 
command line when the program was started. Strangely, the number 
includes the program name itself, so this value is always 1 or more; 
if parameters were provided, it will be 2 or more. 

char *argv[]; now that's confusing, right? This is actually a 
composite of a few things we've already seen. There's a * in there, so 
it's a pointer; the type is char, so there are characters in it, and there 
are square brackets, so it's an array... 

This is actually an array of pointers to characters; each element of 
the array is a string, and each string is one of the parameters provided 
to the program. 
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Just like 
sscanf, 
scanf returns 
an integer 
indicating how 
many values 

it successfully 
read, which 
you can use 
to check for 
errors. One 
problem is 
that scanf 
only removes 
matched 
values from the 
input buffer, 
soifa scanf 
fails to match 
anything, 
what the user 
typed will be 
read again on 
the next call 
to scanf. It 
really is easier 


touse fgets 
and sscanf! 
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It's probably easier to understand that in practice: 
#include <stdio.h> 


="! П | int main (int argc, char *argv[]) 


{ 


int param = 0; 


ls while (param « argc) 
RIGHT] printf ("Parameter Xd is %s\n", param, argv[param]); 
Remember paramss 
that the first H 
item in the return 0; 
argv array - 
argv[0] -is } 
the name of 
ШЕ Ede Try running this as before, just by typing its name. Then try typing 
itself, no e n А 
first parameter. other things after the name on the command line and see what the 
The actual program prints. 
parameters 
start at E Tm 
argv[1]. File Edit Search View Document Project Build Tools Help 
Byer B x se~ mil aja || 41%| в 
Right The <| Symbols |) inputc X 
argc and argv [= ор Functions ||| LN) include <stdio.h> 
arguments to the «f main [3] E бе main (int argc, char *argv[]) 
main function can 4 5 " 
Б int argl, arg2; 
be used to access 6 ; ЖА 
parameters typed 2 сае o 
on the command 3 cod dot 
line when the 11 if (*argv[2] == '+') printf ("%d\n", argl + arg2); 
А 12 if (*argv[2] 1-4) printf (din, argl - arg2); 
program is run 13 if (*argv[2] UC) printf ("%d\n", argl Ж arg2); 
14 A if (*argv[2] == '/') printf ("%d\n", argl / arg2); 
T7 } 
18 
| ———— .É. 
[status 14:36:03: File /home/pi/input.c opened(1). 
Status 
14:37:20: File /homej/pi/input.c saved. 
| Compiler | 14:37:49: File /homeypifinput.c saved. 
| Messages 14:38:09: File /home/pi/input.c saved. 
7 | 14:39:43: File shome/pi/input.c saved. 
line:2/18 со:0 <е:0 INS TAB mode: Unix (LF) _ encoding: UTF-8 filetype:C — scope: unknown 


Here’s an example of a (very) simple calculator written using 
program parameters: 
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#include <stdio.h> 


int main (int argc, char *argv[]) 
{ 
int arg1, arg2; 
if (argc == 4) 
{ 
sscanf (argv[1], "Xd", &arg1); 
sscanf (argv[3], "Xd", &arg2); 


if (*argv[2] == '+') printf ("%d\n", 
if (*argv[2] == '-') printf ("%d\n", 
if (*argv[2] == 'x') printf ("%d\n", 
if (*argv[2] == '/') printf ("%d\n", 
} 
return 0; 


Note that we use *argv[2] to get the first character of the second 
parameter. This should only ever be a single character, but because 
each of the arguments can be a string, argv[2] (without the asterisk) 


argi + 
argi - 
arg1 * 
arg1 / 


arg2); 
arg2); 
arg2); 
arg2); 


is a pointer to a character, not the single character required for a 


comparison using zz. 
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Make sure you separate the arguments from the operator with spaces 
so they're identified as separate parameters; «progname» 2 + 2 


rather than «progname» 242. 


— piigraspbemyplr = 


File Edit Tabs Help 


pi@raspberrypi: ./myprog 
4 


pigraspberrypi: | 


Left The calculator 
reads the two 
values and the 
operator from the 
argv array and 
prints the result 
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“input.txt - /home/pi - ... 


8 (4) ca] „а ж Q [EE pi@respberrypi ~ 


<= 


Wastebasket | File Edit Search View Document Project Build Tools Help 
VB x S» 7 You can use Geany to create 
Е і plain text files as well as С files 


Symbols |> fileine = | input.txt х 
Nin ta 1 This is some text in 
No tags found 2 a test file for the file 
3 input program... 
4 


09:26:27: File /home/pi/main.c saved. 
Status — 09:42:54: A 


le /home/pi/function.h closed. 


Ta 09:42:55: А 


Compiler | 09:44:33: File shome/piffilein.c saved. 


le Jhome/pi/examples.c closed. 


A file pointer is used to геа ессе Unix (LF) encoding: UTF-8 filetype: None 
in the contents of a file 


n the previous chapter, we looked at how to get input from 
the user at the console. In this chapter, we'll look at the 
other common method of input and output in C: reading and 
writing files. 
Many programs need to be able to access files on the host computer's 
disk; even if it’s just for saving user preferences and the like, file access 
is a fundamental requirement for a lot of programming tasks. 
In C, files are accessed by use of file pointers. A file pointer contains 
all the information required to access a file: both its name and location 
on the file system, and the current position within the file at which 
data will be read or written. 
So the first thing we need to do is to get a file pointer. This is done 
using the C function fopen, which takes two arguments. The first 
argument is the path to the file, including its name and extension. 
The second argument is called the file access mode; this is a code which 
indicates whether you intend to read from the file or write to it. 
Let’s look at an example of reading a file. Use your text editor to 
create a file called input.txt in the /home/pi directory on your Pi, 
and type anything you like into it. Save it, and then create and run the 
following program: 
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= [| | #include <stdio.h> 


void main (void) 


{ 
FILE *fp; 
int value; 
fp = fopen ("/home/pi/input.txt", "rb"); 
if (fp) 
{ 
while (1) 
{ 
value = fgetc (fp); 
if (value == EOF) break; 
else printf ("%c", value); 
} 
fclose (fp); 
} 
} 
dia First, we declare a file pointer variable called fp, which has the 
FILE POINTER ] type FILE *. We also declare an integer which we'll use to hold the 
characters read in from the file. 
Never assume We then create the file pointer using the command fopen (for “file 
that fopen open’). We open the file at /home/pi/input.txt, and we set the mode 
has worked - HM zy o aho d А 5 n ; ; 
always check to "rb", which indicates 'read binary'. This creates the file pointer and 
that the value initialises it to the beginning of the file. 
it returns is a We then check to see if the file pointer is non-zero; if the pointer is 
valid pointer c: j : 
ie ete rte hts returned as zero, the file wasn't successfully opened. (For a read, this 
you try to read usually indicates that the file doesn't exist.) 
from a zero. If the file pointer does exist, we call the function fgetc (for ‘file get 
ste Acs lt character’) in a loop; each time this function is called, it reads a single 
nonsense; byte from the file, and then advances the file pointer to the next byte 
if you write in the file. When the file pointer reaches the end of the file, it returns 


Rara the special value EOF (for “end of file’). So we print the value returned 


pointer, you'll : 
probably crash by fgetc each time until it returns EOF. 


the computer! Once we have finished reading the file, we finish access to it by 
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calling fclose (for ‘file close’), which frees the file pointer and [ REMEMBER 

allows you to reuse it to access another file. TO FCLOSE | 
Note that while fgetc reads characters, it returns an integer; 

this is because the code for EOF falls outside the valid range ofa char It's easy to 


variable (0 - 255). Unless at the end of a file, fgetc returns an integer ES to call 
) closeon 
value which can always be treated as a char. your file, but it's 
gu : important to 
Writing a file de -e On some 
: ; : 1 systems, when 
To write to a file, we use a file pointer in exactly the same way, sang tothe 
but we open it in a mode for writing. file system, the 
write doesn't 
i : actually 
#include <stdio.h> complete 
until fclose 
void main (void) is called; if 
{ your program 
doesn't call 
FILE *fp; fclose, you 
int value; might find 
that you write 
R to files and 
fp = fopen ("/home/pi/output.txt", "wb"); nothing shows 
up in them. 
if (fp) 
{ 
for (value = 48; value < 58; value++) 
{ 
fputc (value, fp); 
} 
fclose (fp); 
} 


} 


In this case, we open the file /home/pi/output.txt with the mode 
"wb", which indicates ‘write binary’. This opens the file for writing; 
if this file already exists, the contents are deleted. 

We then call the function fputc (for ‘file put character’) in a loop, 


writing the bytes 48, 49...57 to the file. (These are the character codes | H E 
for the text characters for the 10 digits О, 1...9). As before, we then close 


the file pointer. If you run this and then look in your home directory, you | П m = 
should find the file output.txt, containing the string 0123456789. 
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or writing a file Symbols > filein.c 3€ 


requires a file в 1) #include <stdio.h> 
5 Functions | 
pointer to be & main [3] | 3 void mein (void) 
opened with =. 
fopen, and the IE, MOL 
H 5 8 fp = fopen ("/home/pi/input.txt", "rb"); 
resulting pointer | 3 iF (tp) Li ais 
is then used in 10 pite co 
i 12 
all operations. 13 value = fgetc (fp); 
Remember to 14 if (value == БОР) break; | 
lose the pointer 5 i else printf ("%c", value); 
c 
| 17 
afterwards E р Wee (fold 
with fclose 20 |} 
21 
| 


[ READ AND 
WRITE THE Formatted output 


fputc is useful for writing bytes to a file, but it’s an inconvenient way 
SAME FILE ] a к ; . MN 
of writing text to a file. For this, we can use the fprintf function ('file 


You can open print formatted"). 
a file for 
simultaneous 
reading and 
writing with 
the same void main (void) 
pointer. Set 

the file access { 

mode to "rb+" FILE *fp; 

to read an 
existing file and 
to overwrite it; 
set it to "wb+" 
to create a new if (fp) 

file and be able 

to read back { 

what you've fprintf (fp, "This is some text.\n"); 
written to it; set fclose (fp); 

it to "ары" to 

open a file to } 

both append } 

at the end and 

read from it. 


#include <stdio.h> 


fp = fopen ("/home/pi/output.txt", "wb"); 


fprintf works in exactly the same way as sprintf, but the first 
argument is a file pointer rather than a string. 


Moving around a file 

Quite often, rather than overwriting a file, we just want to add to the 
end of it. To do this, open it with fopen ("/home/pi/output.txt", 
"ab"); - "ab" indicates 'append binary'. If the file exists, output 
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will then be added after the existing file contents; if the file doesn’t 
exist, it will be created and output will start at the beginning. 

Sometimes when accessing a file, we don’t necessarily want to start 
at the beginning. The fseek function can be used to reposition the file 
pointer within the file. 


#include <stdio.h> 


void main (void) 


{ 
FILE *fp; 
int value; 
fp = fopen ("/home/pi/input.txt", "rb"); 
if (fp) 
{ 
fseek (fp, 10, SEEK_CUR); 
while (1) 
{ 
value = fgetc (fp); 
if (value == EOF) break; 
else printf ("%c", value); 
} 
fclose (fp); 
} 
} 


The line fseek (fp, 10, SEEK_CUR) moves the file pointer 10 
bytes ahead of the current position, so this program will print all but 
the first ten characters in the file. The first argument to fseek is the 
file pointer, the second is the offset by which the pointer is to move. 
This can be positive or negative; so fseek (fp, -5, SEEK_CUR) 
moves the pointer 5 bytes back from the current position. 

The third argument to fseek allows you to choose a position relative 
to the start of the file (SEEK_SET) or the end of the file (SEEK_END) rather 
than the current position. So fseek (fp, 12, SEEK SET) positions the 
pointer 12 bytes ahead of the start of the file, while fseek (fp, -17, 
SEEK_END) positions it 17 bytes back from the end of the file. 


[ CHECK 
THE LIBRARY ] 


The C library 
offers a wide 
range of 
functions for 
reading and 
writing data 
from and to 
files; we've 
just looked at 
some of them. 
If you need to 
access a file, 
have a look at 
some of the 
other library 
functions, 

like fread, 
fwrite, 
fscanf, fputs 
and fgets, 

to see if they 
are more 
appropriate 
than the basic 
fputc and 
fgetc we've 
used here. 
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8 Menu [45] Em ж Q (m pi@raspberrypi: ~ | Әряшас- /homefpi-.. | 


420 struct.c- /home/pi - Geany The typedef keyword allows you 
Wastebasket | File Edit Search View Document Project Build Tools Help to create your own new data types 
(9 v& v a | @ x | |%%- 8519 | дат «IY | us 
<| Symbols |> | struct.c Х 
« Functions n ginclude <stdio.h> 
«9 add [9] 3 Gtypedef struct ( 
gman gs) ||4| rims 
8» structs 6 int outval; 
=) f anon struct 0| Z Киш; 
9 


5% invall (4) 
% inval2 |51 
< ошма! [6] 
=) f ypedefs / Enums 
& My DATA |7) 


Status 10:11:26: 
10:12:41: 


Compiler 


[ USE 
DIFFERENT 
NAMES ] 


While it's 
perfectly valid 
to give a local 
variable the 
same name 
as a global 
variable in the 
same program, 
don't do it! If 
you have a 
global anda 
local with the 
same name, 
the local 
version is used 
in the function 
in which it 

is declared, 
and the 
global is used 
everywhere 
else - this 

can result in 
unexpected 
behaviour. 


10:11:43: 


File /home/pl/examples.c opened(3). 


void add (My DATA *d) 
at 


10 = E 
11 À d->outval = d->invall + d->inval2; Jf piso 
ta 7 т 

13 File Edit Tabs Help 
14 void main (void) E 

15 mí 

16 MY. DATA data; 

17 

18 data.invall = 5; 

19 data.inval2 = 7; 

20 add (data) ; 

21 

22 Я printf (“Тһе sum of %d and %d is “din, data.invall, data.inval2, data.outval); 

23 

24 L 


A data structure allows you to 
combine multiple items of data 
in the same type 


New file "untitled* opened. 

File Jhome/pistruct.c saved. 

File Jhome/pi/examples.c closed. 
> Jhome/piinput.t«t closed. 


IO INS TAB  modeUnix(LF) encoding: UTF-8 filetype:C — scope: main 


n this chapter, we're going to look at some of the more 
advanced topics around the use of variables and types, 
including the difference between local and global variables, 
defining new types, and the use of enumerations and data structures. 

When we've used variables in the examples in this book, we've 
always put them inside function definitions. These are therefore local 
variables; that is, variables which are local to those functions and have 
no meaning outside the function. 


Global variables 

C also allows global variables; that is, variables which are defined outside 
all functions. These have global scope, which means they can be read and 
written from any function within the program. Let's look at an example: 


&include «stdio.h» 
int result; 


void add (int a, int b) 


{ >> 
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result = a + b; 


} 


void main (void) 
{ 

add (3, 4); 

printf ("The result is %d\n", result); 
} 


In this example, the variable result is global. It can therefore be 
read or written within both the add function and the main function, 
as you can see, we write a value to it in add and read it back in main, 
and so we don’t need to return a value from add. 

In some ways, this looks easier than passing values about all over 
the place, surely? So why not just do this all the time? The answer is 
memory. Local variables in functions are temporarily allocated space 
while the function is running, and the memory is freed up as soon as 
the function ends. But global variables are allocated space when the 
program starts, and that space isn’t freed until the program ends; if you 
allocate enough of them, you can run out of memory on some systems. 

There’s a better way of making a lot of data available to every 


function, which we will come to a bit later on... 
Type definitions 
In a previous chapter, we looked at the range of variable types in 
C: char, int, float, and so on. C also allows you to define your own 
types, with what is known as a typedef. A typedef is a line of the format 
typedef <existing type> <new name>, usually put at the start ofa 
program. For example: 
typedef unsigned char BYTE; 
This defines a new type called BYTE, which is another name for an 
unsigned char. (Note that by convention, user-defined types are 
usually given names in capital letters. Its not compulsory, but it does 
help to distinguish them from variables when reading the code.) 
When we say this defines a new type, what it really does is to create 
an alias to an existing type. This seems a bit pointless, but it can 
70 
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help in two ways. First, it can make it more obvious what your code 
is doing if you make the type names specific to your program’s data. [ NUMBERED 
Second, by defining specific types, you can get the compiler to warn ENUMS ] 


you if you use the wrong type for a function argument or variable. EAT 
There are a couple of specific cases where typedefs are particularly ноа а 
useful: these are enumerated types апа data structures. enum, the 
compiler 
assigns a 
Enumerated types numeric value 


Often, there’s a use for a variable which can only take one of a few to each of 
possible values. C provides a type called enum for this purpose, which peida 
defines an integer with a fixed set of named values. Here's an example: default, 
numbers the 
#include <stdio.h> first in the 
list as о and 
counts up from 
typedef enum ( there. You can 
override this 
false, by putting an 
true equals sign 
} BOOLEAN; after each 
named value 
5 Қ 5 and setting it 
void main (void) rey Еа 
{ you want. 


BOOLEAN b_var; 


b_var = false; 


if (b_var == true) 
{ 
printf ("TRUE\n"); 
} 
else 
{ 


printf ("FALSE\n"); 


ШТІ 
} 


As you can see, the named values of the enumerated type are used 
instead of numbers for assignments and comparisons. This can make 
code a lot easier to understand, and is a very good way of preventing 

errors, as an enumerated variable can only ever be set to a valid value. 
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A structure 
can contain 
other new 
types (plain 
types, enums 
or indeed other 
structures); 
just make sure 
the typedefs 
for them occur 
before the 
typedef of 

the structure 
in which 

you want to 
include them. 


Structures 
The other really useful thing you can do with a typedef is to use it to 
define a data structure. This is a collection of individual variables which 
are grouped together, allowing you to pass the structure between 
functions rather than the individual variables. 

Here’s an example: 


#include <stdio.h> 


typedef struct { 
int іпуа11; 
int inval2; 
int outval; 

} MY_DATA; 


void add (MY_DATA *d) 
{ 


d->outval = d->inval1 + d->inval2; 


} 


void main (void) 
{ 
MY_DATA data; 


data.inval1 
data.inval2 
add (&data); 


53 
73 


printf ("The sum of Xd and Xd is %d\n", даҒа.іпуа11, 
data.inval2, data.outval); 


So here we use а typedef to create a data type called MY. DATA. The 
definition of the structure consists of the keyword struct with a list of 


variables enclosed by curly brackets; in this case, the structure consists 


of three integer variables. 
In the main function, we declare an instance of the structure as a 


variable called data of type МҮ. DATA. We then access the individual 
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Below An instance of the MYDATA structure is used 
to pass the three integers to the add function 


File Edit Tabs Help 
pigraspberrypi: 
The sum of 5 and 7 


pigraspberrypi: 


elements of the structure by giving the name of the structure 
variable (data), a full stop (.), and the name of the specific element. 
So the line data. invall = 5 sets the value of the element іпуа11 

of data to 5, and so оп. 
The function add takes a pointer to aMY_DATA structure as its 

only argument; as ever, a function cannot change the values of its 
arguments, but can change values pointed to by its arguments, 

so we pass a pointer rather than the structure itself. 

To access the elements of a structure from a pointer to it, we replace 
the full stop with an arrow made up of a minus sign and a greater than 
sign (->). So the add function reads the values of inval1 and іпуа12 in 
the structure pointed to by d, and then writes the result back to outval 
n the same structure; the main function then prints the result from 

he structure. 
Structures are very useful if you need to pass a lot of data around 
between functions; they can be a lot more memory-efficient than 
having large numbers of global variables, as you only need to create 
the structure as and when you need it, rather than taking up memory 
all the time. 


+ = 
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Wastebasket | File Edit Search View Document Project Build Tools Help Every use of the symbol PT is 
T —— replaced by the value in the 
Gm le х Ф 2/8 ЕЕ ] matching #define directive 


<| Symbols |> | circlec x 


i #include <stdio.h> 
=) Funct 
a Functions #define PI 3.14159 
(2 main [4] 
3 9» Macros void main (void) 
Ф РІ 12] float rad = 3; 


float circ = rad * 2 * PI; 
float area = rad * rad * PI; 

printf ("The circumference of a circle radius %f is %f\n", rad, circ); 
printf ("The area of a circle radius %Ғ is %f\n", rad, area); 


FPOODNOUAWNHE 


ыы 


All preprocessor directives, like 
#define, start with a # sign 


| Compiler | LLL Е анак; apl 
ll the examples we’ve seen so far have put all the code for a 
program in a single C file. But once programs get big, it makes 
more sense to be able to split them up into separate files, 
grouping similar functions together. To understand how this works, 

we need to look in more detail at what the compiler actually does. 

n all the examples so far, we've called gcc on a single source file and 
it has created a single executable program. This hides the fact that gcc 
actually does two things: first, it compiles your C source file into what's 
called an object file, and then it links the object file with all the library 
functions to create the executable. This second step is performed by a 
program called a linker; gcc actually does both jobs. 

f you create a program with multiple source files, you just need to 
include the names of all the source files in the call to gcc. It will then 
create one object file for each source file, and then link all your object 
les together to create the executable. 

There's one snag, though. If you've separated your code into separate 
files (usually referred to as modules), you'll have some files which 

make calls to functions in other files in order to work. These files don't 
find out about each other until the linker operates on them; the files 
are compiled individually, and the compiler will complain if you use 
functions in a file it doesn't know about. 


rh 
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While you 

can call 
header files 
whatever you 
like - there's no 
magic about 
the names - it's 
good practice 
to give the 
header file for 
the functions 
in a particular 
C file the same 
name as the C 
file itself, with 
a .hextension 
rather than . c. 
This makes 

it easier for 
someone 
reading your 
code to find 
the files where 
functions 

are defined. 


We fix this using header files. These are files with the extension .h 
which hold the declarations of functions defined in a module, so that 
the compiler can be told about them when they're used by another 
module. We've already seen this many times; remember that line 
#include <stdio.h> at the top of the examples? That is exactly this 
process; it's telling the compiler that functions declared in the system 
header file stdio.h are used in this module. 


Splitting code into multiple files 
Let's look at an example of how this works. Create three files, two with 
the extension .c and one with the extension .h, as follows: 


function.c 


int add vals (int a, int b, int c) 


( 


return а + b + с; 


} 


function.h 
extern int add_vals (int a, int b, int c); 
main.c 


#include <stdio.h> 
#include "function.h" 


void main (void) 
{ 

printf ("The total is %d\n", add_vals (1, 2, 3)); 
} 


Put all three files in the same directory and run gcc, giving it the 
names of both .c files - gcc -o myprog main.c function.c. 

The resulting program will run the main function from main.c, 
which calls the add vals function from function.c. 

A few things to note. First, inside the header file we declare the 
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function with the word extern at the start of the declaration. This tells 
the compiler that this function is to be found externally to the file, i.e. 


in another C file. 


Second, while we have always included stdio.h with its name 
between <> signs, we include function.h in double quotes. The <> 
signs tell the compiler to look for the file in the directory where the 


system’s include files are stored; the 


signs indicate that the file 


is local and is in the same directory as the .c files you’re building. If 
you're creating your own header files, always use double quotes around 


the name when including them. 


The preprocessor 


So what does #include actually do? I 
which is the first stage of compiling; 
before passing them to the compiler i 
what are called directives; these are ea 
The #include directive instructs 
the file which it’s including. So in our exam 


t’s an instruction to the preprocessor, 

it substitutes text within source files 
tself. The preprocessor is controlled with 
sy to spot, as they all start with a É sign. 
the preprocessor to replace the line with 


ple above, the line #include 


"function.h" in the .c file gets replaced with the contents of the file 


function.h, meaning that what’s 


#include <stdio.h> 


passed 


to the compiler looks like: 


extern int add_vals (int a, int b, int c); 


void main (void) 


{ 


printf ("The total is %d\n", add_vals (1, 2, 3)); 


} 
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Left The add_vals 
function is called 
from the main 
function - the 
linker connects 

the call from 
main.c tothe 
function definition 
in function.c 


[ MAKEFILES | 
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#include 
will work on 
any file; it just 
substitutes 
the include 
line with the 
contents 

of the file. 
Occasionally 
you'll see 

this being 
abused; some 
programmers 
bypass the 
use of header 
files by just 
including the 
other C files 
themselves. 
While this does 
work, it's poor 
practice; don't 
be tempted to 
try it! 


#define 


Another useful directive is #define, which can be used to define 
constant values. Look at this example: 


#include <stdio.h> 
#define PI 3.14159 


void main (void) 
{ 
float rad = 3; 
float circ = rad * 2 * PI; 
float area = rad * rad * PI; 
printf ("The circumference of a circle radius Xf is %f\n", 
rad, circ); 
printf ("The area of a circle radius %f is %f\n", rad, area); 


The directive #define is used to set the value of pi. The important 
thing to remember is that PI isn’t a variable; it’s text that will be 
substituted by the preprocessor. The #define line tells the preprocessor 
to go through the file and replace every instance of the symbol PI with 
the digits 3.14159 before passing it to the compiler. So a line which 
does something like PI = 5; will cause an error; the compiler 
will see the meaningless statement 3.14159 = 5;. 

Why is this useful? Why not just declare a float variable called 
PI and set it to 3.14159° A floating-point variable requires 
allocating memory in which to store it; using #define saves 
that memory, which is useful if memory is limited. 

You can also #define functions: 


#include <stdio.h> 
#define ADD(a,b) (a+b) 


void main (void) 
{ 
printf ("The sum of Xd and Xd is %d\n", 5, 2, ADD(5,2)); 
printf ("The sum of %d and %d is %d\n", 3, 7, ADD(3,7)); 
} 
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Again, this does a text substitution; whenever ADD(a, b) appears 
in the code, it's replaced by (a+b), with the values of a and b replaced 
by the arguments to ADD. 

The preprocessor can also evaluate conditions with the #if directive: 


#include <stdio.h> 


void main (void) 


{ 
#if 0 
printf ("Some code\n"); 
#else 
printf ("Some other code\n"); 
#endif 
ї 


With a o after the #if, the code between the #if and the #else 
doesn't get called, but the code between the #е15е and the #endif 
does. If you change the value after the #if to a 1, the code between the 
#if and the #else does get called, but the code between the #else and 
the #endif doesn’t. This is a really useful trick to temporarily remove 
or replace a piece of code when you're debugging. 


€ сопас /home/pi- Geany 


File Edit Search View Document Project Build Tools Help 


[S v ыу ә x ze~ S/R) ға d| è| B 
<| Symbols |> | conde X 
[Б @ functions ||| RENN) include <stdio.h> 
2 
ep main [3] 3 void main (void) 
4 i 
5 H#if 0 
6 printf ("Some code\n"); 
7 |#else 
8 printf ("Some other [codeXn*); 
9 | #endif 
|| 10 l 
(nu 


zm 2 
RES 16:37:16: File /home/pi/circle.c opened(1). 
Status 
16:38:02: File fhome/pi/circle.c saved. 


| Compiler | 16:38:28: File /home/pi/circle.c saved. 


| Messages| 16:50:13: File /home/pi/circle.c saved. 
— MV | 16:58:35: File /home/pi/cond.c saved. 


line 8/11 col:24 зе:0 INS TAB  modeUnix(LF) encoding UTF-8  filetype C — scope main 
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If you use 
#define for 
text strings, 
they should 
be enclosed in 
double quotes, 
otherwise 

the replaced 
text will end 

at the first 
space. So use 
#define MY_ 
TEXT "This 
is some 
text to 
replace." 
The double 
quotes are 
included in the 
replacement, 
so you can 
then just call 
printf (MY_ 
TEXT); 


Left The most 
common use of #if 


is for temporarily 
removing code 

- just wrap it 
between an#if Ө 
and an #endif. The 
#el1se is optional, 
but sometimes you 
want to substitute 
the code you've 
removed with 
different code. 


19 


NEAT 
STEPS 


his book is intended as an introduction 

to the C programming language 

for beginners. It’s not a complete 
description of every detail of C; such a book 
would be at least twice the length of this one, 
and would cover a lot of material that even 
experienced programmers don’t use опа 
regular basis. 

The definitive reference on C is the book 
“The C Programming Language”, by Kernighan 
and Ritchie, now in its second edition. If you’ve 
followed and understood all the material here, 
and want to know about the more advanced 
aspects of C, it’s a good place to look next. 
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If 


if (<test>) 
<code executed if test is true> 


If-else 


if («test») 

«code executed if test is true» 
else 

«code executed if test is false» 


Multiple if-else 


if («test1») 
«code executed if testi is true» 
else if (<test2>) 
«code executed if +еѕ+1 is false and test2 is true» 
else 
«code executed if testi is false and test2 is false» 
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Switch 


switch (<variable>) 


{ 


case <testvall> : «code executed if variable is testval1> 
break; 


case <testval2> : <code executed if variable is testval2> 


break; 
default : <code executed if variable is neither 
testval1 nor testval2> 
break; 


Switch with fall-through 


switch («variable») 


{ 
case <testvall> : «code executed if variable is testval1» 
case «testval2» : <code executed if variable is either testval1 
or testval2> 
break; 
default : «code executed if variable is neither 
testval1 nor testval2> 
break; 
} 


In all loops, the keyword break can be used to exit the loop and resume 
execution immediately after the loop. 

In all loops, the keyword continue can be used to skip code remaining in the 
body of the loop and resume execution at the next iteration of the loop test. 
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While 


while (<test>) 
<code executed repeatedly while test is true> 


Do-while 
do 

<code executed once and then repeatedly while test is true> 
while (<test>) 


For 


for (<initial condition>; <increment>; <termination condition>) 
<code executed repeatedly until termination condition is true> 
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VARIABLE TYPES 


char Single alphanumeric character il 
signed char Signed 8-bit integer (-128 - 127) 1 
unsigned char Unsigned 8-bit integer (0 - 255) 1 
short, signed short Signed 16-bit integer (-32768 - 32767) 2 
unsigned short Unsigned 16-bit integer (o - 65535) 2 
int, signed int Signed 32-bit integer (-2147483648 

-2147483647) 4 
unsigned int Unsigned 32-bit integer 

(0 - 4294967295) 4 


long, signed long Signed 32-bit integer (-2147483648 - 


2147483647) 4 
unsigned long Unsigned 32-bit integer (0 - 4294967295) 4 
float Floating-point value (*/- 3.402823 x 10%) 4 


double Double-precision floating-point value | А B [ 
(CaP 10) 8 


Depending on platform, int can be either a short int (16 bits) ога 
long int (32 bits); on Raspbian, as per the table above, int is a long 


(32 bit) integer value. 
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SPECIFIERS 


Specifier 
%с 
%а 
жа 
%и 
%1и 


%о 


%10 
%х, %X 
%1х, %1X 
% 
^e 


%s 
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Format / type 


Alphanumeric character - char 


Signed decimal value - int 


Signed decimal value - long int 


Unsigned decimal value - int 


Unsigned decimal value - long int 


Octal value - int 


Octal value - long int 


Hexadecimal value - int* 


Hexadecimal value - long int* 


Floating-point value - float 


Exponential value - float 


Text string - char pointer 


* %x displays a value as hexadecimal with lower-case letters a through 
f; XX displays it with upper-case letters A through F. 
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The width (or minimum number of characters printed) can be set 
by inserting a number between the % and the letter; this will pada 
value shorter than this with spaces at the start. To pad with spaces at 
the end, insert a - between the % and the number. To pad with leading 
zeroes, insert a 0 between the X and the number. 

For example, to print an integer variable with the value 42, using 
the format specifier "5d" will print 42 with three spaces before it. 
The format specifier "%-5d" will print 42 with three spaces after it. 
[he format specifier "05d" will print it as 00042. 

The number of decimal places shown for a floating-point or 
exponential value can be set by inserting a decimal point followed 
by a number between the % and the letter; this can be combined 
with a width by putting the width before the decimal point. 

For example, to print a floating-point variable with the value 
76.54321, using the format specifier "%.2" will print it as 76.54. 

The format specifier "%08.2Ғ" will print it as 00076.54. (Note that 
the decimal point takes up one character of the specified width.) 


OPERATORS 


The operators in the table below produce a result which can be assigned to 
another variable, і.е. с = a + b, but do not affect the values of a or b. 


a+b Addition 
a-b Subtraction | А Е | 
ажр Multiplication 


a/b Division 
a%b Modulo (calculate remainder) 
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a&b Bitwise AND 
a |b Bitwise OR 


a^b Bitwise XOR 

a << b Bit shift left 

а >> b Bit shift right 
~a Bitwise 175 complement 
la Logical NOT 


The operators in the table below modify the value of a directly. 


a++ Increment a by one* 
a-- Decrement a by one* 
++a Increment a by one* 
--aa Decrement a by one* 

a+=b Increment a by b 

a -= b Decrement a by b 

а *= b Multiply a by b 

а /=b Divide a by b 

a X- b a = remainder of a/b 
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а & b Bitwise AND a with b 
а |=b Bitwise OR a with b 
a ^= b Bitwise XOR a with b 
а <<= b Bit shift a left by b 

а >>= b Bit shift a right by b 


*The difference between a++ and ++a is if they are used in a test, such 
as if (a++), a++ tests the value and then increments it, while ++a 
increments the value first and then tests the incremented value. 


The operators in the table below are used for comparisons in tests. 


Is equal to 


l= Is not equal to 


> Is grea 
< Is less 
>= Is grea 


<= Is less 


ter than 


han 


ter than or equal to 


han or equal to 
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